A2HTML

Section: User Manuals (1)
Updated: APRIL 1999
Index Return to Main Contents

NAME

a2html - convert a text file to html

SYNOPSIS

a2html [options] [textfile] [-o htmlfile] ...

DESCRIPTION

a2html scans and converts a textfile into a htmlfile. The result is a preformatted 7 bit htmlfile. The textfile may use a 8-bit Atari charset or 8-bit iso-8859-1 charset. Everything that looks like an URL or email address will be linked. Multiple files can be converted at once. Can read from stdin and write to stdout.

OPTIONS

textfile: a2html reads the input from textfile. If no textfile, stdin will be used and stdout for output. With one or more textfile, files will be created with proper filetype.
-o <htmlfile>, -out <htmlfile>: Write output to <htmlfile>. If you do not use this option, a2html will use the same filename as the textfile, but with html as filetype.
-, -stdout: Sends htmlfile to stdout. Only necessary if textfile is used.
--help: Prints default charset and command usage.
--version: Prints a2html version.
-q, -quiet: Quiet mode, no errors will be reported to stderr.
-p, -pause: a2html waits for a keypress before it terminates.
-dumpargs: Dumps all arguments on stderr. Could be used to validate the ARGV function.
-crlf: Default is to use a single LF to finish a line. Use this option, if you want a CR too. It does not matter how the lines are finished in the textfile, the generated htmlfile will always be either LF or CRLF terminated.
-iso, -iso-8859-1: Textfile uses an iso-8859-1 charset.
-atari: textfile uses an 8 bit Atari charset.
-notags: The htmlfile will not be created with <html> <head> etc tags. You can paste or merge the file into a existing htmlfile. However a2html will still use <pre> tags.
-nodoctype: Don't output the W3C document type definition (3.2) at the beginning of the htmlfile.
-title <string>: Changes the document title in the htmlfile. More titles are allowed and a title applies only to the current textfile. Use when a2html is started from a shell. The <string> will be charset parsed, so you may use 8 bit characters.
-footer <string>: Outputs the <string> after the last </pre> and just before </body>. <String> will not be charset parsed, nor will links be created. This <string> may have linefeeds and tags.
-nopre: Omit <pre> </pre> tags. The output may look ugly in your browser.
-nobr: -nopre (see above) will terminate all lines with <br>. Use -nobr to omit <br>.
-nolinks: Don't check for url in textfile and don't create links.
-nomail: Don't check for anything that looks like an emailaddress.
-emailsource: a2html reads the textfile as an email and will only display Date, From, Reply-To, To, Cc and Subject fields. However, a2html will not convert quoted-printable nor mime-encoded emails. These will be displayed as they look (in the bodytext). When this option is invoked, a2html will change default charset to iso-8859-1. The complete header is hidden in comments, just select "view source" in your browser.
-separator <string>: Outputs the <string> between the header and body text. <String> must be valid html code and will not be charset parsed. Example: -separator '<hr>'
-bodybgcolor <color>: Changes the default background color white to <color>.
-bodytext <color>: Changes the default text color black to <color>.
-bodylink <color>: Changes the default link color blue to <color>.

FILES

a2htmlrc, .a2htmlrc, ~/a2htmlrc, ~/.a2htmlrc: Initializations commands for a2html.

BUGS

None, at the moment.

AUTHOR

Tommy Andersen <tommya@post3.tele.dk>

This document was created by man2html, using the manual pages.
Time: 10:39:53 GMT, April 06, 2025